home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 60.zip / BS1 part 60 / DBman d1.adf / update.doc < prev    next >
Text File  |  1991-01-07  |  10KB  |  311 lines
  1.  
  2. dBMANV INSTALLATION
  3. -------------------
  4.   This file describes the system-independent improvements.
  5.  
  6. *** -> Amiga users: please read the file "amiga.5.3" on this disk!
  7.  
  8.        **** New in version 5.3 ****
  9.  
  10.     Sorting and Indexing are faster.  How much faster depends on your
  11. particular data and sorting/indexing condition.  Other factors that affect
  12. speed are the BUFFERS variable in CONFIG.DBM and the particular performance
  13. of your hard/floppy/ram disk.  Given all these variables, the speed increase
  14. should be between 20% and 3x faster.
  15.  
  16. ***************************************************************
  17. The remainder of this file refers to changes in 5.2 and before:
  18.  
  19.  
  20.        ****Note to PC-DOS and all UNIX/XENIX version users****
  21.  
  22. Changes in the way dBMAN V 5.2 looks for the config.dbm file and other
  23. overlays.
  24.  
  25. dBMAN version 5.2 now looks for all overlay files (i.e. ASSIST.DBM, HELP.DBM,
  26. CONFIG.DBM, ITEMR.DBM, DBM_REP.DBM, all DBM_FUNC files, DBM_OVL1.DBM, ERR.DAT,
  27. and ERRHELP.DAT) to be loated in the path specified by the environment
  28. variable called, "DBMANOVL".  If you don't specify the DBMANOVL variable,
  29. dBMAN will expect the files to be in the current directory for PC-DOS and in a
  30. directory called, "/usr/lib/dbman" for UNIX/XENIX users.
  31.  
  32. Refer to your Operating System manual for information on creating environment
  33. variables.
  34.  
  35. On some UNIX versions of dBMAN V, there is a file called, "ibmset.dbm". This
  36. file, tells dBMAN V which terminals support the IBM Graphics Character Set.
  37. You can add more terminal name to the list ass needed with any text editor.
  38. The ibmset.dbm file is located in the /usr/lib/dbman directory.
  39.  
  40.  
  41.                   ****** For Commodore AMIGA users ******
  42.  
  43. The AMIGA version of dBMAN V, uses the Shift-Right Arrow and Shift-Left Arrow
  44. keys to pan in BROWSE, DISPLAY and SHOP.  The manual states that the pan keys
  45. are Control-Right and Left Arrows.  This is incorrect.
  46.  
  47. Also, the file selector on the AMIGA currently doesn't show a ./ meaning to
  48. go up a directory level.  To change the level of the directory you want 
  49. displayed, press the TAB key while in the File Selector and type in the path
  50. name you wish files to be displayed in.
  51.  
  52.  
  53. To speed up some operations of dBMAN V, you may want to set the default
  54. for "system" to RAM:.  This will cause temporary files created by dBMAN V
  55. to placed on the RAMdisk.  You may also want to copy ASSIST.DBM, DBM_OVL1.DBM,
  56. ERR.DAT and DBM_REP.DBM to the RAMdisk and set the "dxx" to default to RAM:.
  57.  
  58. Example:  SET DEFAULT SYSTEM TO RAM:
  59.           SET DEFAULT DXX TO RAM:  &&Be sure all of the neccessary .DBM files
  60.                                    &&are copied to the RAMdisk.
  61.  
  62.  
  63.  
  64. FOR ALL dBMAN V USERS
  65.  
  66. ****NOTE****  IF you are using the REPORT FORM command, you MUST set the
  67.  relations yourself before issueing the REPORT FORM command.
  68.  
  69. The SET DB3 ON command now compares strings and creates memory variables
  70. in the same manner as dBASE III Plus.
  71.  
  72. Example:     ? "ABC" = "A"      &&If DBS is ON True, False if DB3 is OFF.
  73.              company = company  &&If DB3 is ON and a database field with the
  74.                                 &&name of company is present, a memory
  75.                                 &&variable will be created called, "company".
  76.                                 &&If DB3 is OFF, dBMAN will just store the
  77.                                 &&contents of the database field back into the
  78.                                 &&database field.
  79.  
  80.  
  81. Following are commands and functions that were not included in the manual:
  82.  
  83.  
  84.  
  85. Syntax:  ASC(Cexp>)
  86.  
  87. Description:  This function is the same as rank in the Reference Manual.  This
  88. was added for dBASE III+ compatibility.
  89.  
  90. Syntax: ASSIST
  91.  
  92. Description:  This command will execute the ASSIST.RUN program.  The ASSIST
  93. program is an easy-to-use menu driven interface that allows you to execute
  94. dBMAN V commands. 
  95.  
  96. With ASSIST you can create, modify and delete databases, indexes and records.
  97.  
  98.  
  99.  
  100. Syntax:  AVERAGE [<Fi>] [<expList>] [TO <varList>] [<scope>] [<FOR Lexp>]
  101.  
  102. Description:  This command adds the numeric value in the <expList>, divides it
  103. by the number of records added and stores the result in the <varList>.  If the
  104. <expList> is not specified, the first eight fields in the file will be
  105. averaged.  A maximum of 64 fields can be averaged.
  106.  
  107.  
  108. The number of expressions in the <expList> must match the number of variables
  109. in the <varList>.
  110.  
  111. The default for <scope> is ALL.
  112.  
  113.  
  114. Example:
  115.        ITEM           CATEGORY    UNITPRICE
  116.  
  117. 1    NAVEL ORANGE        FRUIT      .50
  118. 2    CHERRIES        FRUIT      .75
  119. 3    CHICKEN:WHOLE        FRUIT     1.05
  120. 4    STRAWBERRIES        FRUIT      .99
  121.  
  122. AVERAGE UNITPRICE TO TTL
  123.  
  124. ?TTL
  125.  
  126. .82
  127.  
  128.  
  129. Syntax:  REFRESH GETS
  130.  
  131. Description:  This command causes dBMAN V to redraw all of the gets for the
  132. READ command.  Use this command if you have a GET-file and change the contents
  133. of a GET field.
  134.  
  135.  
  136. Syntax: RESUME
  137.  
  138. Description:   The command RESUME is currently not supported by dBMAN V.  You
  139. can use the <ResumePRG> key outlined in KEYBOARD DEFINITIONS of the
  140. supplemental manual.
  141.  
  142.  
  143. Syntax: RW [<Fi>] FORM <fileFRM> [FOR <Lexp>]
  144.  
  145. Description: This command is the same as REPORT FORM except the databases,
  146. index files, and report page information is loaded from the FRM file.
  147.  
  148.  
  149. Syntax:  SELFILE("<Var1>","<Var2>")
  150.  
  151. Description:  The SELFILE function will display a list of file names in the
  152. pathname of <Var1>, with the filenames matching <Var2>.  The variables must be
  153. predefined and enough space reserved for a 32 character pathname (<Var1>) and
  154. a 13 character filename (<Var2>).
  155.  
  156. If the user aborts the file selector, the filename variable <Var2> will be
  157. empty.
  158.  
  159. Example:
  160.     path = 'C:\dbman' + space(30)
  161.         filen = '*.dbf' + space(11)
  162.         assign selfile("path","filen")
  163.         if trim(filen) <> ''
  164.       ...
  165.       ...
  166.         endif
  167.  
  168.  
  169. Syntax:  SET EXCLUSIVE ON|OFF
  170.  
  171. Description:  This command is used on multi-user versions of dBMAN V.  If on,
  172. all database and index files will be opened and locked.  This is a dBASE
  173. compatibility command that enables single user code to work with file locking
  174. on a multi-user system.  There are some good points to having EXCLUSIVE ON (or
  175. USE <file> EXCLUSIVE).  If a database is used exclusively, the database and
  176. index information will be cached in memory.  This will make some commands
  177. operated up to 4 times faster than a non-exclusive operation.
  178.  
  179. Example:  SET EXCLUSIVE ON
  180.           USE TEST  &&(4,000 records  USE TEST EXCLUSIVE would work too)
  181.           REPLACE ALL DFIELD WITH DATE()  &&This might take 1:00
  182.           SET EXCLUSIVE OFF
  183.           USE TEST  &&(Now it will not cache in memory)
  184.           REPLACE ALL DFIELD WITH DATE()  &&This will take at least 4:00
  185.  
  186.  
  187. ***NOTE***    By default EXCULSIVE is ON.
  188.  
  189.  
  190.  
  191. Syntax:  RECEIVE(<devno>,<count>,"<Cexp>")
  192.  
  193. Description:  RECEIVE enables you to get information from a serial port.
  194. <devno> is the device number to get the data from.  <count> is the number of
  195. characters to get. <Cexp> is a predefined variable enclosed in quotes that
  196. will contain the data received.
  197.  
  198. Note:  You should issue the COMSTAT() function call to see if there is data
  199. waiting.  Otherwise, dBMAN will wait until data is received before returning
  200. control.
  201.  
  202. Example:
  203.     buffer = space(50)
  204.     assign receive(0,50,"buffer")
  205.  
  206. On the PC version of dBMAN V the device numbers are 0 for COM1: and 1 for
  207. COM2:. 
  208. On the Atari ST version 1 is for the serial port.
  209.  
  210.  
  211.  
  212.  
  213. Syntax:  SEND(<devno>,<count>,"<Cexp>")
  214.  
  215. Description:  SEND enables you to send information to a serial port. <devno>
  216. is the device number to send the data to.  <count> is the number of characters
  217. to be sent. <Cexp> is a predefined variable enclosed in quotes that contains
  218. the data.
  219.  
  220. Example:
  221.     buffer = 'This is a test.'
  222.     assign send(0,len(buffer),"buffer")
  223.  
  224. On the PC version of dBMAN V the device numbers are 0 for COM1: and 1 for
  225. COM2:. 
  226. On the Atari ST version 1 is for the serial port.
  227.  
  228.  
  229.  
  230. Syntax:  SET MEMOWIDTH TO <Nexp>
  231.  
  232. Description:  SET MEMOWIDTH TO allows you to specify how many characters wide
  233. the memo field is to be displayed when the @ SAY <memo> command is used.
  234.  
  235.  
  236. Syntax: UNIQUEFN([<pattern>])
  237.  
  238. Decsription:  This function returns a unique file name.  If the optional
  239. pattern is specified, it will be prepended to the file name returned.
  240.  
  241. Example:  var = UNIQUEFN("TEST")
  242.           ? var
  243.         TESTaaaa0123
  244.  
  245.  
  246.  
  247. Syntax:  USE <file> [INDEX <file.NDX>] [EXCLUSIVE]
  248.  
  249. Description:  The exculsive option has now been added to the USE command.  See
  250. SET EXCLUSIVE ON|OFF for a description on useage.
  251.  
  252.  
  253.  
  254.  
  255. New directives in CONFIG.DBM.
  256.  
  257. A new directive called "PRINTER" has been added.  This specifies the default
  258. printer for dBMAN.  This is the default for the SET PRINT TO command.
  259.  
  260.  
  261. Special notes
  262.  
  263. Be sure not to use the minus "-" mathematical operator in file names.  This
  264. will cause will problems when you are using the alias identifier.
  265. i.e.  IN-OUT.DBF will cause dBMAN to think that you want to subtract IN from
  266. OUT.
  267.  
  268. If you are using the relation type SCAN, you must not position the child
  269. databases yourself.  i.e.  GO %CHILD TOP.  This will cause the relationship
  270. between the parent and the child to be incorrect until the parent database is
  271. skipped.
  272.  
  273. If you have a SCAN relation set up, you must not BROWSE, SHOP, or DISPLAY the
  274. parent database.  Doing this will cause the parent reocrd to be repeated as
  275. many times as the child record matches the parent.
  276.  
  277. ***WARNING!!***
  278.  
  279. If you want to encrypt a database with the ENCRYPT command, be sure that it is
  280. NOT A dBASE III+ database.  It WILL CORRUPT THE DATABASE PERMENENTLY!!  To
  281. ENCRYPT the database do the following:
  282.  
  283. SET DB3 OFF
  284. USE <dBASE III+ database>
  285. COPY TO <new file>
  286. USE <new file>
  287. ? LOGIN(<username>,<password>,<password table>)
  288. SET ENCRYPT ON
  289. ENCRYPT
  290.  
  291.  
  292. Now use the <new file> as your encrypted database.
  293.  
  294.  
  295. dBMAN BBS FOR TECHNICAL SUPPORT AND PRODUCT UPDATES!
  296.  
  297.  
  298. We have a bulletin board that you can use to get the latest information and
  299. product updates of dBMAN.  As new revisions are made we will place the update
  300. on the board and if you have the access you can download the file.  The BBS
  301. operates 24hrs a day 7 days a week.  Accepted baud rates are: 2400, 1200 and
  302. 300.  Settings are: 8-bit, NO parity and ONE stop bit. Phone number is: (408)
  303. 723-9047
  304.  
  305.  
  306. Technical support hours are 9:00 am - 12:00 noon and 1:30 pm to 3:00 pm PDT. 
  307. The phone number is: (408) 723-8384.
  308.  
  309.  
  310.  
  311.